home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / ab20 / ab20_archive / utilities / misc / qmouse-2.02.lzh / qmouse.doc < prev    next >
Text File  |  1992-02-22  |  5KB  |  152 lines
  1. QMouse V2.02
  2.  
  3. Written by Dan Babcock
  4.  
  5. -- This program REQUIRES Kickstart 2.0 or higher. --
  6.  
  7. I missed one program more than any other when I switched to
  8. Kickstart 2.0: QMouse, the venerable mouse-utility. I tried every
  9. other program of its type that I could find, but every utility I
  10. tried had bugs/quirks, lacked important features, and worst of
  11. all was HUGE. Discouraged (and annoyed), I decided to write my
  12. own. QMouse 2.0 (this program) is a completely new program, not
  13. an update to QMouse, but I couldn't think of a more fitting name;
  14. after all, my intent was to make a utility "like QMouse" - why
  15. not call it QMouse!? I hope this doesn't lead to too much
  16. confusion. On to the all-important feature list...
  17.  
  18. FEATURES:
  19.  
  20. * Automatic window activation after Amiga-M and Amiga-N: the
  21. previously active window will be made active. VERY useful!!! Does
  22. not poke screen structure like the original QMouse did (bad :-)).
  23.  
  24. * Optional top-line blanking for 2320/3000 owners who wish to
  25. mask the "half line flicker" effect. Does not blank the border,
  26. just the top line.
  27.  
  28. * System-friendly mouse blanking. Uses only the documented
  29. function SetPointer. Does not interfere with other sprites (e.g.
  30. JRComm's cursor).
  31.  
  32. * Mouse acceleration/threshold
  33.  
  34. * "PopCLI" feature. The CLI (actually any program may be
  35. executed) will have a sensible current directory, stack, and
  36. path.
  37.  
  38. * Click-to-front and click-to-back. New for V2.02: Click-to-Back
  39. will intelligently decide whether to perform a Window-To-Back or
  40. Screen-To-Back operation.
  41.  
  42. * SunMouse (activates window under mouse pointer). Personally I
  43. don't care for this feature, but if you like it, it's here. (And
  44. in this version, it actually works. :-)).
  45.  
  46. * Screen blanking. No special effects; use another program for
  47. that stuff.
  48.  
  49. * Option to completely disable DisplayBeep (some programs overuse
  50. it and it gets VERY annoying!)
  51.  
  52. * Option to remap a few Northgate keys.
  53.  
  54. * Starts own background process (no need to RUN).
  55.  
  56. * Written in assembly (efficient). Not a commodity.
  57.  
  58. * Fully public domain. Source code included.
  59.  
  60. * ONLY 3K !!!!!!!!!!!
  61.  
  62.  
  63. -----------------
  64. Using QMouse V2.0
  65. -----------------
  66.  
  67. To see the parameter template type "Qmouse ?". Most likely it
  68. looks like gibberish to you, though, so I'll explain the options:
  69.  
  70. (Please note: If you don't specify an option, the option is OFF.
  71. The default set of options is therefore all OFF).
  72.  
  73. MBLANK (abbreviated M):
  74.  
  75. This specifies the number of seconds of mouse inactivity     
  76. before the mouse pointer is blanked. The mouse pointer is also
  77. blanked whenever you hit a key.
  78.  
  79. Examples: m=3, mblank=9, M 10
  80.  
  81. SBLANK (abbreviated S):
  82.  
  83. Screen blanking - works same as mouse blanking basically.
  84.  
  85. NOFLICKER (abbreviated N):
  86.  
  87. This option will blank the top line of the display. (Only useful
  88. to 2320/3000 owners). This function inspects the system copper
  89. list, so it probably won't work in future Kickstarts.
  90.  
  91. CMD:
  92.  
  93. Specifies the command to execute when the user hits left-Amiga-
  94. ESCape. Default is "newcli". Use like this: CMD="newcli
  95. con:0/0/640/400". Important!!! The current directory, stack, and
  96. path of the newly created CLI will be that of the CLI where
  97. QMouse was originally executed. Therefore, place QMouse in your
  98. startup-sequence *after* STACK and PATH commands!!
  99.  
  100. ACCELERATION (abbreviated A):
  101.  
  102. Specifies mouse speed-up factor.
  103.  
  104. Examples: acceleration 3, a=4, a 9
  105.  
  106. THRESHOLD (abbreviated T):
  107.  
  108. Specifies a threshold (minimum movement) required to apply acceleration factor. The default is zero. Example: T=1.
  109.  
  110. CLICKTOBACK (abbreviated CTB):
  111.  
  112. Specifying "ctb" or "clicktoback" will enable a feature whereby
  113. both mouse buttons being pressed simulatenously will send the
  114. window under the mouse pointer to the back.
  115.  
  116. CLICKTOFRONT (abbreviated CTF):
  117.  
  118. This option specifies the number of mouse clicks required to
  119. bring the window under the mouse pointer to the front. Example:
  120. ctf=2.
  121.  
  122. SUNMOUSE:
  123.  
  124. Specifying "sunmouse" turns on the "Sun Mouse" feature. I don't
  125. recommend you use it because it's annoying and causes problems
  126. with some programs. (Unless you happen to like it :-)).
  127.  
  128. NOBEEP:
  129.  
  130. Completely disables DisplayBeep (the routine that flashes the
  131. screen).
  132.  
  133. NORTHGATE:
  134.  
  135. For Northgate keyboard users only: remaps a couple keys. (Page Up
  136. -> Shift-Cursor-Up, etc). Sorry, if you want to change it you'll
  137. have to edit the source and reassemble.
  138.  
  139. QUIT:
  140.  
  141. Completely de-installs QMouse. (Why would anyone want to do
  142. that??!!). It may fail to quit if some other utility has taken
  143. over the same library vectors.
  144.  
  145. ----------
  146. The Author
  147. ----------
  148.  
  149. If you want to contact me for some reason, please send email to
  150. d6b@ecl.psu.edu.
  151.  
  152.